package com.ruoyi.system.mapper;

import java.util.List;
import java.util.Map;
import com.ruoyi.system.domain.SpffUsers;

/**
 * 用户Mapper接口
 * 
 * @author xjj
 * @date 2025-09-11
 */
public interface SpffUsersMapper 
{
    /**
     * 查询用户
     * 
     * @param id 用户主键
     * @return 用户
     */
    public SpffUsers selectSpffUsersById(Long id);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户
     */
    public SpffUsers selectSpffUsersByUsername(String username);

    /**
     * 查询用户列表
     * 
     * @param spffUsers 用户
     * @return 用户集合
     */
    public List<SpffUsers> selectSpffUsersList(SpffUsers spffUsers);

    /**
     * 新增用户
     * 
     * @param spffUsers 用户
     * @return 结果
     */
    public int insertSpffUsers(SpffUsers spffUsers);

    /**
     * 修改用户
     * 
     * @param spffUsers 用户
     * @return 结果
     */
    public int updateSpffUsers(SpffUsers spffUsers);

    /**
     * 删除用户
     * 
     * @param id 用户主键
     * @return 结果
     */
    public int deleteSpffUsersById(Long id);

    /**
     * 批量删除用户
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteSpffUsersByIds(Long[] ids);

    /**
     * 根据用户ID列表批量查询用户
     * 
     * @param ids 用户ID列表
     * @return 用户集合
     */
    public List<SpffUsers> selectSpffUsersByIds(List<Long> ids);

    /**
     * 更新用户最后登录时间
     * 
     * @param params 参数map
     * @return 结果
     */
    public int updateLastLoginTime(Map<String, Object> params);

    /**
     * 更新用户统计数据
     * 
     * @param params 参数map
     * @return 结果
     */
    public int updateUserStats(Map<String, Object> params);

    /**
     * 检查用户是否存在
     * 
     * @param id 用户ID
     * @return 是否存在
     */
    public boolean existsById(Long id);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户
     */
    public SpffUsers selectByUsername(String username);

    /**
     * 根据手机号查询用户
     * 
     * @param phone 手机号
     * @return 用户
     */
    public SpffUsers selectByPhone(String phone);

    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户
     */
    public SpffUsers selectByEmail(String email);

    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户
     */
    public SpffUsers selectSpffUsersByEmail(String email);

    /**
     * 搜索用户
     * 
     * @param params 参数map
     * @return 用户集合
     */
    public List<SpffUsers> searchUsers(Map<String, Object> params);

    /**
     * 统计搜索结果数量
     * 
     * @param params 参数map
     * @return 数量
     */
    public int countSearchUsers(Map<String, Object> params);
}
